home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir35 / ctcm23.zip / CATCOMP2.DOC < prev    next >
Text File  |  1990-12-23  |  11KB  |  256 lines
  1.                            INSTRUCTIONS FOR CATCOMP2.EXE
  2.             Copyright (C) 1990 by Wayne A. Davis  ALL RIGHTS RESERVED
  3. _______________________________________________________________________________
  4.                 ENDORSED BY: Mr. Rick Hillier, Author of CATDISK.
  5.  
  6.  
  7.      December 23, 1990
  8.  
  9.      Program:  CATCOMP2.EXE  Version 1.3
  10.  
  11.  Description:  CATDISK UTILITY for BBSer's
  12.                CatDisk can be found in Compuserve Lib #:9  as CD450.EXE  
  13.                                                   Forum: IBMSYS
  14.  
  15.      Purpose:  A:  Creates text filelists that show what files YOU have
  16.                    stored via CATDISK 3.56-4.50 that a target BBS Master
  17.                    Download list lacks.
  18.                
  19.                B:  Creates SORTED, UNCLUTTERED text filelists of BBS Master
  20.                    Download lists which have all the comments, titles and
  21.                    graphics removed to assist in finding files YOU lack.
  22.  
  23.                    Shareware ($10 reg. fee)
  24.  
  25.  
  26. Why this 
  27. information
  28. is important:  Most BBS's have a requirement that for "X" amount of Downloads 
  29.                there must be a certain percentage of uploads, otherwise access
  30.                to the Download section is revoked.  The Lists that CATCOMP2
  31.                generates, show EXACTLY which files you could upload without
  32.                duplicating an existing file.  CATCOMP2 eliminates the need to
  33.                manually search hardcopy in order to choose uploadable files!
  34.  
  35.  
  36.  
  37.  Limitations:  For CATDISK Version 3.56-4.50 ONLY.
  38.                 4000 filenames in TARGET D/L list.
  39.                  2000 filenames in Catdisk's DTA file.
  40.                   Hard Drive is ADVISABLE.
  41.                    COMPCFG.CFG  MUST reside in same directory as CATCOMP.EXE.
  42. _______________________________________________________________________________
  43. _______________________________________________________________________________
  44.  
  45.   How to use 
  46.     CATCOMP2:  NOTE: I recommend that No TSR's be in memory along with CATCOMP2
  47.                      as CATCOMP2 uses substantial amounts of memory when
  48.                      processing large filelists.  However, you MAY find that it
  49.                      will work, try it and see.  You will receive an error
  50.                      message if CatComp2 cannot run due to insufficient memory.
  51.               
  52.  
  53.  
  54.        1. Execute COMPCFG FIRST! (only required once, SKIP this step if 
  55.                                   upgrading from an older Catcomp Version.)
  56.  
  57.           COMPCFG.EXE has been modified for easier use, however, NO change has
  58.           been made to the COMPCFG.CFG file format.
  59.  
  60.  
  61.  
  62.        2. Execute CATCOMP2. 
  63.  
  64.  
  65.  
  66.        3. Answer "Default" question and optionally enter DTA filename.
  67.  
  68.           The DTA filename is the CatDisk CATALOG FILE you want CATCOMP2
  69.           to use.   Remember to include the extention: .DTA
  70.  
  71.  
  72.  
  73.        4. Answer "ZIP file" question.
  74.  
  75.           Answering "y" tells CatComp2 you additionally want to process
  76.           filenames which exist within ZIP files.  These expanded filenames
  77.           must exist in the DTA file you use.
  78.  
  79.  
  80.  
  81.        5. Answer the "Sorted List" Question.
  82.  
  83.           Answering "y" tells CatComp2 to create a sorted and uncluttered
  84.           listing of the TARGET BBS FileList.  File will have .SRT extension.
  85.  
  86.  
  87.  
  88.        6. Answer the "Announce" question.
  89.  
  90.           Answering "N" will prevent the Warble tone from occurring at program
  91.           completion.   (great for those "all-nighters")
  92.  
  93.  
  94.  
  95.        6. Enter the "MASTER BBS Listing Filename:"
  96.  
  97.           Type in the FILENAME.EXT (ONLY) of the TARGET BBS FileList that you
  98.           want to process.
  99.  
  100.  
  101.  
  102.        7. <F1> will abort operation.
  103.  
  104.            Hitting F1 at any time during execution will terminate the program.
  105.  
  106.  
  107.  
  108.            During program execution, CatComp2 will show what it is currently
  109.            doing.  Much of the information shown will appear in the header 
  110.            portion of the respective .CMP and .SRT lists.
  111.  
  112.  
  113.  
  114.        8. WARBLE TONE will announce program completion IF SELECTED.   You will
  115.           return to DOS.
  116.  
  117.  
  118.  
  119.        9. Type, List or Print the file(s) having the same name as the BBS list,
  120.           BUT with the .CMP or .SRT extension.
  121.  
  122.                The generated COMPARISON list ALWAYS has the extension: .CMP
  123.                              The SORTED list ALWAYS has the extension: .SRT
  124.  
  125.                BOTH are created in the same directory the target MASTER BBS
  126.                D/L list resides in.
  127.              
  128.                    I.E. BBS D/L List was:  TOM.LST
  129.               CATCOMP2 generated file is:  TOM.CMP in the SAME directory.
  130.  
  131.  
  132.      The header/footer information in the .CMP and .SRT files is self-
  133.           explanatory with perhaps 2 exceptions:  The "Run Time:" entry in the
  134.           .CMP files. and the "Duplicate filenames" entry in the .SRT files.
  135.  
  136.  
  137.      The "Run Time" entry  in .CMP files is the minutes and seconds CatComp2
  138.           took to do all Loading, Sorting and Processing operations, starting
  139.           when "enter" is pressed after last keystroke and, ending when writing
  140.           files to disk begins.
  141.  
  142.  
  143.      The "Duplicate Filenames" entry in .SRT files is the number of filenames
  144.           that exist in the MASTER BBS List more than once.  I.E. If the
  145.           filename "DISK.FIL" appeared 4 times and the filename "TEST.FIL"
  146.           appeared 6 times in the MASTER BBS list,  "Duplicate Filenames"
  147.           would be: 8   These EXTRA filenames are discarded.
  148.  
  149.  
  150.  
  151.       10. An ASTERISK (*) preceeding a CATDISK filename indicates that file
  152.           is contained WITHIN a ZIPfile. (IF you've enabled the function by
  153.           answering "Y" to the "ZIP file" question.)
  154.  
  155.  
  156.  
  157.       11. If "SORTED list" option is used, the generated file will have the
  158.           same NAME, but with the .SRT extension.
  159.  
  160.                    I.E. BBS D/L List was:  TOM.LST
  161.           CATCOMP2 generated SORTlist is:  TOM.SRT in the SAME directory.
  162.  
  163.           This listing is the SORTED, UNCLUTTERED list of MASTER BBS filenames
  164.           with duplicate filenames removed.
  165.  
  166.  
  167.  
  168. Note:  When Analyzing the structure of a listing, CATCOMP2 looks for the
  169.        period in the filename, A CONSISTANT place where DOUBLE SPACES occur,
  170.        and consistant  "/" or "-" on the same line as would be used in dates. 
  171.  
  172.                       EXAMPLE  -->    12/12/90 or 12-12-90
  173.                                         ^  ^        ^  ^
  174.  
  175.        Lines in the listing having BBS Filenames that have no period,  or
  176.        lacking a position where DOUBLE SPACES occur, or lines without dates
  177.        will be SKIPPED, but should you encounter a rogue filename that was
  178.        uploaded in LOWERCASE, a conversion to UPPERCASE will be made by
  179.        CATCOMP2.  Other criteria is involved, but these are the FIRST things
  180.        it looks for.  Below are some example filenames that show what is
  181.        acceptable and non-acceptable.
  182.  
  183.        Examples:   MYFILE.COM    THISIS.      12/12/90 or 12-12-90 - ACCEPTED
  184.                          ^             ^
  185.                      FILE COM      FILE   or  File.  w/ NO date    - SKIPPED 
  186.                          ^             ^
  187.  
  188.        As of this release, The MAJORITY of BBS's in my area follow this
  189.        format, but if this should change, or, you find that most in your
  190.        area are different, drop me a line.  A suitable updated version will be
  191.        released at first opportunity.  I am constantly striving to improve
  192.        CATCOMP2 as my revision history proves.
  193. ______________________________________________________________________________
  194.             DO NOT DISTRIBUTE CATCOMP2 OR RELATED FILES INCOMPLETE.
  195.  
  196.                         There are 4 files in the Zip:
  197.  
  198.                      CATCOMP2.EXE  The main program.
  199.                       COMPCFG.EXE  Configuration program.
  200.                      CATCOMP2.DOC  Documentation textfile.  (This File)
  201.                      CATCOMP2.HST  Revision History textfile.
  202.  
  203.                 DO NOT bundle CATCOMP2 or it's files with ANY
  204.                  other software in the same compressed file.
  205.  
  206.        DO NOT alter CATCOMP2, COMPCFG, . DOC or .HST files in ANY way.
  207.  
  208. CATCOMP2 has received the Endorsment of:  Mr. Rick Hillier,  Author of CATDISK!
  209.  
  210.      CATCOMP2 is COPYRIGHTED SHAREWARE,  IT IS NOT FREE.  Try it out, then if
  211. you decide to continue using it, a registration fee of $10.00  U.S. is required
  212. UNLESS you've already sent a fee for a previous CATCOMP2 version.  Drop a check
  213. in an envelope, lick a stamp and send it off.  This fee entitles you to use past,
  214. present, AND future releases of CATCOMP2 under the same registration.
  215.  
  216.           REGISTERED users have PRIORITY for any replies or inquiries.
  217.  
  218.      THIS IS VERY INEXPENSIVE considering how much time and grief it will spare
  219. you, and how much TIME has gone into development!  Comments and suggestions are
  220. welcome.  By mail, send an S.A.S.E. for reply.  Enough said.
  221.  
  222.  
  223. PLEASE, send CATCOMP2 registration fees to:   Wayne A. Davis
  224.                                               17617 N. 9 St.,  #2076
  225.                                               Phoenix, Arizona  U.S.A.
  226.     Make checks payable to:  Wayne Davis                   85022-1943
  227.  
  228.  
  229.            CompuServe ID: 74040,3076  - comments, suggestions, replies.
  230.  
  231.      The LATEST versions of CATCOMP2 and CATDISK are available for download
  232.      from Compuserve and:
  233.  
  234.                   The ChalkBoard BBS in Phoenix, Arizona. 
  235.                   (602) 395-9726   (8N1)   9600 Baud Max.
  236.            NO verification required.  The BBS is a SPITFIRE board.
  237.              
  238.              To Log-on:      Answer-  CATDISK for "FIRST NAME"
  239.                                       "ENTER" for "LAST NAME"
  240.                                        "Cat" for "PASSWORD"
  241.  
  242.                      You may also leave mail in the area.
  243. _______________________________________________________________________________
  244.  CATDISK is Copyrighted by: Rick Hillier 
  245.                             405 Barrington Lane   ALL Registration fee's
  246.                             Waterloo, Ontario     for CATDISK are to be
  247.                             Canada N2T 1H9        sent to Mr Hillier.
  248.  
  249.        My personal thanks to Mr. Hillier for his endorsment, comments and
  250.   suggestions during the creation of this utility which proved to be of
  251.   great help and value to me, and also to Mr. Michael Benedict, Sysop of the
  252.   Chalkboard BBS, who has graciously provided the use of his BBS as a
  253.   "Home Base" for CATCOMP.
  254.  
  255.  
  256.